Skip to main content

Full text of "Icepik Users Guide (1983)(ICECO)"

See other formats


[ 
[ 



ICEPIC 



USERS GUIDE 



ICECO 

INTEGRATED COMPUTER EQUIPMENT COMPANY 



c 
[ 
c 
[ 
[ 
[ 
c 
c 
c 
[ 
[ 
[ 
[ 
[ 

D 



X C E F> I C 
T-ABL.E OB- COBfTEHnrs 

1- Introduction 

1 . 1 Hardware Features 

1.2 Software Features 

1.3 Equipment Needed 
1-3 ICEPIC Function 

1.4 ICEPIC Documentation 
1.4 Trademarks 

1.4 Copyright and Content 

2. Installation and Checkout 

2.1 Hardware Setup 

2.2 Software Backup 

2.3 Checkout Procedure 

2.3 Shortcut to Using Your ICEPIC 

3. Selecting a Driver Program 

3.1 Driver Program Types 

3.2 Memory and Hardware Variations 
3-2 AUTORUN.SYS Files 

3.3 Picking the Driver You Need 
3.3 Self -Booting Programs 

3.3 System Reset 

3.3 Re- loading a Driver 

4. Print Only Drivers 

4.1 PHANDLER P: Print Handler 

4.2 SIOSIM Serial I/O Simulator 



i - 



5. CHANDLER 

5.1 Disk Graphics Dump Handler 

5.2 CHANDLER Function Codes 

6. ICECRAF 

6.1 Multi -Function Graphics Driver 

6.2 ICECRAF Tutorial 

6.3 ICECRAF Usage Notes 

6.4 ICECRAF Control Command Summary 

6.5 ICECRAF Keyboard Command Summary 

7. Accessing the ICEPIC Hardware 

7.1 Status Locations and Values 

7.2 The Joystick Address 

8. Other Interfaces 

8.1 Using ICEPIC With a Modem 

9. Utility Programs 

9.1 ICECHK Diagnostic 

9.2 SETUP Program 

9.3 REBOOT Program 

9.4 SHOMICRO Program 

9.4 Displaying "Artist" Pictures In BASIC 

10. Sample Application Requirements 

10.1 BASIC Programs 

10.2 AtariWriter 

10.3 LJK Letter Perfect 

10.3 B/CRAPH 

10.4 Koala Micro Illustrator and AtariArtiat 

10.5 MicroPainter 



ii 



11. Error Reporting 

11.1 Error Codes 

11.1 ICEGRAF Keyboard Commands 

12. Trouble-Shooting 

12.1 Printer Hardware Setup 

12.1 ICEPIC Hardware Connections 

12.2 Improper use of ICEPIC Software 

12.3 Actual Hardware Failures 

13. Warranty 



- iii - 



[ 

D 
C 
D 
[ 
[ 
[ 
[ 

D 
[ 
[ 
C 

c 



N 



This manual will help you to get the most out of your new 
ICEPIC. To begin with, we at ICECO would like to thank you 
for purchasing the ICEPIC. We want you to receive years of 
trouble-free service and suggest that you read the 
installation and checkout portion of this booklet (at 
least) . To insure that you do not damage your computer, 
printer, or ICEPIC, make sure to follow the instructions. 
After hooking up your ICEPIC, you must load an ICEPIC 
program (driver) to make use of your ICEPIC — this manual 
will tell you which program to use. In addition, we have 
provided you with many other useful programs -- you should 
read the instructions in this booklet to properly use most 
of them. 

The ICEPIC has many features, both in its hardware and in 
its supporting software — they are summarized below. 

HARDWARE FEATURES 

- Supports any printer which uses a parallel (Centronics) 
interface. 

*- Supports printers which can also be used by non-Atari 
computers . 

- Supports printers being used by next generation Atari 
computers . 

- Uses only one "joystick" port. 

- Requires no additional interface (850) "box". 

- Requires no modifications to the Atari or the printer. 

- Compact size takes up virtually no desk space. 

- Requires no bulky external power supply and power cord. 

- Needs no extra (expensive) cable to connect it to the 
printer. 

' Can be extended by low cost "joystick" extension cords. 

- Provides more complete printer status for application 
programs . 

- Can run simultaneously with a modem interface. 



- 1.1 



[ 



SOFTWARE FEA-rURES 

- Can be used aa a "noraal" printer with aoat 
application programs. 

- Requires no program modifications. 

- Resolves most of the "bugs" in the standard printer 
software • 

- Can print any d-bit character to the printer. 

- Data is sent to the printer immediately — no wait for 
end -of -line. 

- Detection and recovery when printer goes off-line. 

- Supports Epson and Okidata compatible printer graphics. 

- Most special functions can be keyboard or program 
activated at any time. 

- Application programs Bre unaware of keyboard activated 
functions and no program changes are required. 

- Optional simultaneous "hardcopy" of any screen output. 

- Printout of any logical line of text on the screen. 

- Printout of all screen text lines. 

- "Graphic" printout (dump) of any screen. 

- Several screen dump formats including multiple gray 
shades and variable printed dimensions. 

- "Atari" font or user-defined font printing. 

- Rotation and expansion of "Atari" or user fonts. 

- "Translated" printing for control characters and 
inverse data. 

- Hakes it simple to list programs containing control 
characters . 

- Disk dump and restore of any screen. 

- Disk dump and restore of character tables. 

- "Warm" re-boot capability. 

- And many more. 

You should note that many of these features, such as screen 
dump to print, screen dump to disk, and printing with 
multiple user fonts, usually require separate programs. 
These programs can each cost nearly as much as your ICEPIC. 
In addition to these software features, the ICEPIC provides 
hardware functions of boxes and cables costing much more 
than it does. In short, you received a lot when you bought 
an ICEPIC -- we know that you will appreciate it even more 
after you have used it for a while. 

- 1.2 - 



[ 



3. 



[ 
[ 
[ 
[ 

r 
[ 

[ 



1. Atari Computer: 400, 600XL, 800, SOOXL, or 1200XL. 

2. A printer equipped with a parallel, Centronlca 
conpatlble. Interface. 



3. A dlak drive and a DOS dlakette. 

ICEPIC and ICEPIC aupport aoftware dlakette. 

XCEPXC FUMC^'TXON 

The nana ICEPIC la an acronym for Integrated Computer 
Equipment Parallel Interface Converter. The ICEPIC la an 
electronic circuit which connecta any parallel Interfaced 
printer to moat Atari computera. The ICEPIC contalna 
electronic circulta to convert the electrical algnala needed 
by the printer to thoae uaed by the Atari. The circuitry la 
houaed In a compact caae which alao contalna a molded-ln 
plug to connect the ICEPIC Into the prlnter'a parallel 
(Centronlca) Interface 3ack. A "joyatick" type plug and 
cord connecta the ICEPIC into one of the Atari controller 
Oacka (^oyatlck port). The ICEPIC geta Ita power <a very 
amall amount) from the computer, ao It needa no additional 
power aupply. The ICEPIC la needed becauae the printer 
required many more algnal llnea than a 3oyatlck port can 
provide. The ICEPIC provldea everything needed to hook up a 
printer: Interface circuitry and cable. Since Atari 
operating ayatem (OS) aoftwtare la not dealgned to have a 
printer connected Into the 3oyatlck porta, aome apeclal 
aoftware la required to make the ICEPIC work. Thla aoftware 
la provided with the ICEPIC. In addition, the ICEPIC 
aoftware provldea many additional featurea not normally 
available on the Atari with a more "atandard" printer 
connection. 



1.3 



t:gei^:s:g DocuMEN-TA-rxoM 

Thia manual waa prepared with AtariWrlter and printed by 
AtarlWrlter ualng an ICEPIC connected to an Okldata 
Hlcrollne 92 printer. An ICECO proprietary proportional 
spacing print driver was used to more evenly spread the 
"justified" apaclng produced by AtarlWrlter. The printout 
was photographically reduced for final printing. The label 
on your software diskette was printed using your ICEPIC In 
Its final operational check. 

TRADEMARKS 

ICECO, ICEPIC, and ICETEE are trademarks of Integrated 
Computer Equipment Company, St. Loula, MO. Atari, Atari 
400, Atari 600XL, Atari 800, Atari 600XL, Atari 850, Atari 
1200XL, AtarlWrlter, and AtarlArtlat are trademarks of 
Atari, Inc. Epson, Epson MX, and Graftrax are trademarks of 
Epson America, Inc. Letter Perfect Is a trademark of LJK 
Enterprises, Inc. Okldata and Okldata Mlcrollne 92 are 
trademarks of OKIDATA Corporation. Koala Micro Illustrator 
Is a trademark of Koala Technologies. B/GRAPH Is a 
trademark of Irata Press, Ltd. MlcroPalnter Is a trademark 
of DataSoft, Inc. 

cos>YRXGH-r AMD c:;oM-ri5MT 

All ICEPIC software Is copyrighted by Integrated Computer 
Equipment Company. The retail purchaser of the ICEPIC and 
Its software Is entitled to copy any of this software for 
his or her personal use with the ICEPIC. However, any copy 
for any other use Is prohibited. 

Every effort has been made to Insure the accuracy of the 
documentation contained In this manual. Since ICECO Is 
continuously Improving the software, we cannot guarantee the 
accuracy of the printed material after the publication date 
and disclaim liability for changes, omissions or errors. We 
do, however, appreciate being Informed of any such errors, 
so that future publications can be corrected. 



- 1.4 - 



[ 



INSTTALI-ATIOliI 

Installation of the ICEPIC is a two part procedure. First, 
the hardware (ICEPIC "cable") must be connected between your 
computer and printer; and second, the necessary "driver" 
program must be loaded. 



HARDWARE SETUP 

1. Turn off the power to both the computer and the printer. 

2. Plug the circuit (big) end of the ICEPIC into the 
parallel (Centronics) connector on your printer. For most 
printers, the cord will be pointing to the right when you 
are facing the front of the printer (it will only go in one 
way and it is a snug fit, but don't force it -- yours may go 
in the other way around). 

3. Plug the "joystick" end into game port 2 (you may use 
port 4 on non-XL computers) - 

4. Set your printer setup switch for "automatic line feed" 
after a carriage return to "on" (see the manual which came 
with your printer for details). 

5. Turn on the power for the computer and the printer (and 
your disk drive) . 

6. Boot DOS as usual. 

IMPORTANT M! Always turn off the power to both the printer 
and the computer before you connect or disconnect the 
ICEPIC. Failure to do so may damage your computer or your 
printer or your ICEPIC. 

You may turn the power off to the printer when you are not 
using it. You should note that roost printers will set "top 
of form" when you turn the power back on. If you turn off 
the power to your Atari computer, the ICEPIC will NOT reset 
your printer (to avoid losing the "top of form" setting). 

- 2.1 - 



Thla completes the hardware setup. Normally you can keep 
your printer and computer connected by the ICEPIC. If you 
find the ICEPIC cord to be too shorty it can be extended up 
to twenty feet or more by game port extension cords 
(available from ICECO and many other sources). If you want 
to easily switch between the ICEPIC and any other joystick 
device, you may be interested in another ICECO product, the 
ICETEE game port switch box — with it you can switch at any 
time and you also have a four foot extension cable. 

ICEPIC software is distributed on a write-protected (not 
copy protected) diskette in DOS 2 format (single density); 
the diskette does not contain a copy of DOS (it cannot be 
booted) . You must supply whatever version of DOS you prefer 
to use. Eventually you will copy only the driver programs 
you will be using onto your diskette from the ICEPIC 
diskette. Before you do this, however, make a copy of the 
ICEPIC diskette, then save the original as a backup in case 
you destroy the copy -- never write on the original, since 
this may void your warranty. 

DOS 3 users must use the conversion option (A) to convert 
programs from the ICEPIC software diskette to another 
diskette in the newer DOS 3 format. We suggest that you 
convert everything on the ICEPIC diskette. Keep the ICEPIC 
original for your backup. 

In the instructions which follow, you will be instructed to 
"load" various programs. You should use the "load program" 
option or command of the DOS which you are using. The 
driver programs will "run" and install themselves as 
required. They return to DOS but remain in memory to "talk" 
to your printer whenever you do any print functions. 



- 2.2 



C 
[ 



CHSCKOU-r PROCEDURE 

Insert your copy of the ICEPIC diskette in your disk drive 
and load ICECHK2 if your ICEPIC is plugged into port 2; if 
you are using port 4, load ICECHK4. This program will check 
out your ICEPIC and print some test data on your printer to 
make sure everything is functioning properly. If it fails, 
it will tell you what seems to be wrong. If you cannot 
correct the problem, see the chapter on trouble-shooting. 
If all of the printed data is on the same line, you need to 
set the automatic formfeed option on your printer -- see the 
manual which came with your printer for details. ICEPIC 
software, like d50-type interfaces, requires this option for 
proper operation. 

Note: At this time you are NOT ready to use the ICEPIC -- 
the checkout program knows how to talk to the ICEPIC, but 
other programs are not so well informed. They need a 
"driver" program to send the correct signals to the ICEPIC 
and thereby make your printer print. The next sections will 
tell you how to select the driver you need. 



SHORTCUT TO USXNG YOUR XCEPXC 

By now, you probably want to "play" with your ICEPIC and 
your printer. The sections which follow might seem a bit 
overwhelming right now (in fact, you might not need to know 
all of the information). So you can try the following 
"shortcuts" and come back to the nitty-gritty after you have 
had a chance to become better acquainted with your ICEPIC. 
If you turn to the chapter on ICEGRAF (page 6.1) and follow 
the instructions for the ICEGRAF Tutorial, you should get a 
good idea of what the ICEPIC can do. After that, if you 
turn to Sample Application Requirements (page 10.1) and find 
the program(s) you intend to run, you can proceed to follow 
the instructions listed for them. In any case, if you want 
to get the most out of the ICEPIC, you should read through 
all the details and refer back to them when needed. 



- 2.3 



[ 



[ 
c 
[ 
c 
[ 
c 

c 
c 

D 
[ 

c; 
c 



Since the ICEPIC plugs into a game (^oyatick) 3ack instead 
of the "channel**, it cannot be used by the standard 
operating system <0S> print handler which expects an Atari 
d50 or similar device on the channel. Instead, a "driver** 
program must be loaded which will replace the standard OS 
"P:" jprint handler. Once this has been done, programs which 
use '*P:*' will be unaware of the fact that the printer is 
connected by an ICEPIC. Unfortunately, the choice of the 
proper driver program is not always easy because some 
software does not follow the '*standards** for memory 
utilization (low and high memory address pointers are not 
always observed). 

DRXVER PROGRAM TYPES 

ICEPIC comes with three major types of driver programs: 

1. Simple **P:'* handler (PHANDLER), an enhanced replacement 
of the Atari OS **P:*' handler. 

2. Serial I/O simulator (SIOSIH), which intercepts channel 
I/O destined for the printer and routes it to the ICEPIC 
instead (needed by programs which do not go through '*P:** for 
printing, such as custom print handlers used by some word 
processing programs) . 

3. Multi^f unction ICEGRAF program, which in addition to 
both of the functions above includes many other functions, 
such as: screen dump to print (text or graphic); screen 
dump/restore to disk; Atari or user font printing; hardcopy 
of all screen output; and many more. 

Each of these driver types will be further described in the 
sections which follow. ICEGRAF normally is the driver of 
choice. But since it uses around 4k of memory, there are 
times when one of the other drivers is required (each of the 
other drivers use about 256 bytes of memory) . 



- 3.1 - 



[ 



MEMORY AND HARDWARE VARXATXONS 

There are several veralone of each of the drlvera. They are 
needed because the ICEPIC can uae either port 2 or port 4 
and because the drivers Auat be loaded at varying locations 
in memory based on application program requirements. In 
addition, Okldata printers use a different graphics format 
than the more "standard" Epson format (ICEGRAF must be 
customized to the printer graphics format being used). 
Rather than have the drivers somehow determine which options 
you are using (which would make them much larger), several 
versions of each program are provided. 

In general, the drivers can be loaded Into page 6 (600 to 
6FF hex) or at the current low memory address (MEHLO) or 
into high memory (RAMSIZ) . In the last two cases, the 
address pointers are changed after the load. So if your 
application program does not use page 6, you can use a page 
& driver. If your program (and your DOS) respect HEHLO, you 
can use a low memory driver. If your program respects high 
memory, a high memory driver can be used. Note that BASIC 
meets all of these requirements (so long as the BASIC 
program doesn't get too "fancy"). 

AUTORUM.SYS F-IL-ES 

Any of the drivers can be made into an "AUTORUN .SYS" file 
(by rename or by copy). In addition, other programs can be 
copy /appended to them to create a compound "AUTORUN. SYS" 
file. Using "AUTORUN. SYS" is sometimes essential. It is 
required to use some cartridge programs and it la needed in 
order to use a "low memory" driver with DOS 2 (DUP.SYS, the 
DOS 2 "menu" program, does not always respect low memory -- 
using "MEH.SAV" can sometimes get around the problem, but it 
is so slow that moat users avoid it) • 



3.2 - 



D 
[ 



PXCICXNG THE DRXVER YOU NEED 

Pleaae refer to the charts in the chapter on "Sample 
Application Requirements" to help make your decisions. If 
your program is not listed, try whatever is described for a 
program similar to it. When you have determined which 
driver(a) you will be using, copy them to the appropriate 
diakette(s), renaming them if so desired (for example, to 
"AUTORUN.SYS" or some other name you can remember easily for 
loading) • 

SEI^F- — BOOT X MG PROGRAMS 

Sometimes it is not possible to load any driver. This 
happens with programs which "auto-boot" and perhaps use a 
non-standard disk format. However, this can often be 
resolved by using the ICEPIC "REBOOT" program. REBOOT 
allows you to first boot normal DOS and load a page 6 or 
high memory driver from a normal DOS diskette. REBOOT then 
"fakes" a system boot, keeping the driver in memory. The 
section on REBOOT will tell you how to use the REBOOT 
program . 

SYSTEM RESET 

Pressing [SYSTEM RESET] will usually simply "re-initialize" 
any of the drivers (as you probably want); however, the high 
memory versions of ICEGRAF must "sacrifice" part of 
themselves due to a quirk in the way OS initializes the 
system (see the chapter on ICEGRAF for more details). Some 
application programs may process RESET in strange ways and 
can cause the drivers to "disappear"; you will have to boot 
the system if this happens. 

RE — I^OADXMG A DRXV^EFT 

Finally, an important WARNING: Do NOT re-load an ICEPIC 
print driver (or load a different driver) once any of the 
ICEPIC print drivers has been loaded. Results are very 
unpredictable and may lead to problems later. If you must 
re-load, always boot DOS first. 



- 3.3 - 



[ 
[ 
[ 
[ 
c 
c 
c 
[ 
[ 
[ 
[ 
[ 
[ 
[ 
[ 



PHAMDL.ER E> = PRXMT HAMDI^ER 

The ICEPIC *'P:'* handler program (PHANDLER) replaces the 
normal OS **P:*' handler. In addition to performing the aame 
functions as the standard OS "P:" handler with an ••850" 
connected printer, several enhancements have been added: 

1. The ••sideways** OPEN option will cause all data to be 
printed **as is**. Thus the end-of-line (EOL) character (hex 
SB, CHRd<155>) does not cause a carriage return and is 
treated as data. This is useful when printing graphics or 
downloading a character set (when hex 9B is just data) . If 
••sideways** OPEN is not used, printing an EOL will cause a 
carriage return (hex CD, CHR$(13))' to be printed on the 
printer (like an 850 always does). 

2. When a CLOSE is issued, lines not ending in EOL will not 
be extended to 40 positions. This solves the problem of 
using LPRINT with ••continued*^ data (ending with semicolon) 
-- LPRINT performs an OPEN, PRINT, and CLOSE. 

3. Data is sent to the printer immediately (data is not 
buffered). This can be handy when printing control 
characters such as a formfeed. 

4. If the printer goes off-line during printing, it will 
not cause an error which could end a program and require 
reprinting from the beginning. 

There are 4 versions of the ''Pz^^ handler: 

PHANDLER. 2LM -- Joystick port 2, loads in low memory. 
PHANDLER. 4LH -- Joystick port 4, loads in low memory. 

PHANDLER. 2P6 -- Joystick port 2, loads in Page 6. 
PHANDLER. 4P6 -- Joystick port 4, loads in Page 6. 



4.1 - 



SXOSXM Sl^RXAI^ X^O SXMU1-.ATOR 

The ICEPIC aerial I/O simulator program (SIOSIM) 
"intercepts" serial I/O which was intended to go to a 
printer on the "channel" (through an 850 interface) . SIOSIM 
is designed for use with programs which do not use the 
system "P:" routine (such as custom print drivers used by 
some word processing programs) . SIOSIM can be used with the 
standard OS "P:" handler instead of PHANDLER, but SIOSIM 
only implements the "sideways" (transparency) enhancement of 
PHANDLER -- the other enhancements are fixes to the OS "P:" 
handler. 

There are 4 versions of SIOSIM: 

SIOSIM. 2LH -- Joystick port 2, loads in low memory. 
SIOSIM •4LM "- Joystick port 4, loads in low memory. 

SIOSIM. 2P6 -- Joystick port 2, loads in Page 6. 
SIOSIM. 4P6 -- Joystick port 4, loads in Page 6. 



If SIOSIM functions (or its equivalent functions in IGEGRAF) 
are used when you also have another printer connected to an 
Atari 850 or similar interface device, you may get strange 
results. SIOSIM does not actually intercept serial I/O 
until after the initial selection sequence is sent over the 
channel -- this may leave your 850 interface in "limbo" 
because it will never see any more of the command which 
appeared to be destined for its printer. It is best to turn 
off the printer on the 850 to reduce confusion. 



[ 



4.2 - 



GHANDI^ER 

OXSK GRAPHXCS DUMP Hi^MDl^ER 

The ICEPIC disk graphics handler program (CHANDLER) 
Inplements a new device^ "G:", which allows the current 
screen (any graphics mode) to be dumped to disk and later 
restored. CHANDLER also provides fuctlons to dump and 
restore the current character display table. Unlike most 
handlers. It Is only necessary to "OPEN" the dump file with 
the proper function code. All actions required to perform 
the dump or restore will occur during the OPEN. It is not 
necessary to Issue a CLOSE — a CLOSE Is done automatically 
when the OPEN function Is completed. The file specification 
looks like a normal disk file name with the "D" replaced by 
a "G". The BASIC format would looks like: 

OPEN #x,f «0,"Gn:fllename.ext" 

Where x » lOCB # (1-7) 

f s function code, described on the next page 
n = drive number (can be omitted for drive 1) 
fllename.ext = normal DOS file name and optional 
extender 



Screen dumps will be "compressed** to reduce the data which 
Is written to disk. If any DOS error occurs, the error will 
be returned by CHANDLER (you will get the same error codes 
DOS returns). There Is a "stand-alone" version of the "C:" 
handler, CHANDLER. LM, which loads In low memory. The "C:" 
handler Is also Included as a part of ICECRAF, which also 
Includes some keyboard functions to access "C:" (see the 
next chapter). CHANDLER. LM can be destroyed by DUP.SYS. 
Use MEM.SAV or make CHANDLER an AUTORUN.SYS to avoid this. 
Many application programs load at a very low address and 
assume MEMLO is even lower -- these programs can destroy 
CHANDLER in the process. In most cases you will probably 
want to use the ICECRAF program to get "C:" functions. 



- 5.1 - 



[ 



GHAMDI^EI^ FUTMC-rxOM CODES 

The following function codes are accepted by CHANDLER on an 
OPEN. Normal DOS error codes are returned if the function 
fails. 

DUMP SCREEN TO DXSIC 

f = 8 -- Write (create) a disk dump of the screen. All 
information needed to restore the current display will be 
written to disk. If the file name exists it will be 
replaced by the new dump. 

RESTORE SCREEN FROM DXSK 

f « 4 -- Read a dumped screen. The current screen GRAPHICS 
mode must be the same as was in effect when the dump file 
was created. The screen and display list will be restored 
to the condition at the time the dump was made. The screen 
parameters such as cursor position, margins, and color 
registers will also be restored. 

DUMP CHARACTER TABL.E 

f « 9 -- Dump the current character display table to disk. 
"CHBAS" points to the table to dump (RAM or ROM). 

RESTORE CHARACTER TABLE 

f = 5 -- Restore the character display table from a disk 
dump of it. The current CHBAS must point to the RAM area 
where the restore will be made. 

The character table functions are quite useful if you create 
your own character set for printing with ICEGRAF. You can 
save the default system table, and then restore it to a RAM 
location where you can modify it as desired. Finally, you 
can dump your custom character set and restore it whenever 
you need it. 



- 5.2 - 



[ 
[ 



X C E G R A F 

MUL-TTi — E-uNrc-rxoiii GRAPHxcs drxve:r 



ICEGRAF provides all of the functions of the other ICEPIC 
drivers: 

PHANDLER -- P: handler for "normal" printing. 

SIOSIM -- Serial I/O simulator for use with other P: 
handlers. 

CHANDLER -- G: handler for disk dunp/restore. 

In addition, ICEGRAF provides many functions which can be 
accessed through keyboard commands, independent of the 
application program which you are running. There are many 
other functions which can be accessed by "printing" certain 
control sequences from the application program. These are 
summarized later and described in detail in the tutorial. 

There are several versions of ICEGRAF: 

For Epson graphics (Graftrax) and compatible printers: 

ICEGRAF. E2L -- Uses joystick port 2, loads in low memory. 
ICEGRAF, E4L -- Uses joystick port 4, loads in low memory. 

ICEGRAF. E2H -- Uses joystick port 2, loads in high memory. 
ICEGRAF. E4H -- Uses joystick port 4, loads in high memory. 

For Okidata graphics compatible printers: 

ICEGRAF. 02L -- Uses joystick port 2, loads in low memory. 
ICEGRAF. 04L -- Uses joystick port 4, loads in low memory. 

ICEGRAF. 02H -- Uses joystick port 2, loads in high memory. 
ICEGRAF. 04H -- Uses joystick port 4, loads in high memory. 



- 6.1 - 



XCEGRAF TUTORXAL- 

Slnce the nunber of ICEGRAF functiona ia rather large, they 
can beat be underatood by example. To help you with thia, a 
tutorial program has been included with the software. To 
run this tutorial, do the following: 

1. Connect your ICEPIC. 

2. Boot DOS with BASIC present. 

3. Exit to DOS from BASIC (DOS command). 

4. Insert your copy of the ICEPIC software diskette. 

5. Load ICEGRAF. xxH (See table on page 6.1). 

6. Return to BASIC (Run cartridge) and RUN "D : TUTORIAL" . 



The tutorial will take you through moat of the ICEGRAF 
functions and allow you to experiment with them. If your 
printer does not support graphics, you will have to skip 
over many parts of the tutorial since most of the functions 
work only with graphics printers. When you have completed 
the tutorial, you will be given a chance to print it all on 
your printer. All of the commands described in the tutorial 
are summarized on pages 6.4 and 6.5 of thia manual. 



6.2 - 



[ 
[ 
[ 
[ 
[ 
[ 
[ 
[ 
[ 
[ 
[ 
[ 
[ 
[ 
[ 



XCEGRAF* USAGE NOTES 



IGEGRAF Is a "self -relocating" program. It deternlnes where 
high or low menory la, relocates Itself (changes instruction 
addresses) and moves itself to high or low memory. It then 
changes the high or low memory pointers beyond itself. 
Obviously any program you run should not modify anything 
beyond the "new" memory address. 

The low memory versions work best as an AUTORUN.SYS file 
along with cartridge based programs. The low memory 
versions are easily destroyed by most disk based application 
programs because such applications do not expect MEMLO to be 
so high (ICEGRAF uses almost 4k> and so the applications are 
loaded on top of ICEGRAF. The high memory versions work 
well with any program which' respects the top of memory 
addresses and are particularly useful if you must "REBOOT" 
to run a program. 

There are several things to note when using ICEGRAF. To 
begin with, if you define your own character display table 
for the Atari screen it will also be used for printing in 
"graphic mode". Graphic mode printing is available even if 
serial I/O simulation is being used (by some word processing 
programs, for example) . Thus, you can include special fonts 
in documents being printed by your word processor. 

The disk functions <G:) may not work when a non-standard DOS 
is being used. The "disk" functions of the high memory 
versions of ICEGRAF will not survive a [SYSTEM RESET3 
because OS insists on clearing a screen area in highest 
memory before ICEGRAF can change the high memory address; 
ICEGRAF will "sacrifice" G: to the system because of this -- 
but the rest of ICEGRAF continues to be functional . 

If you run a program which alters the keyboard interrupt 
vector, ICEGRAF keyboard functions will disappear. Some 
programs may do keyboard input by scanning the hardware -- 
this can sometimes lead to undesired results. 



- 6.3 



XCEGRAF COMMAND SUMMARY 

CONTROI.. COMMANDS 

The following commanda are recognized In data which la 
printed In "graphic" mode. "Esc" means the current ICEGRAF 
escape character, default la ASCII ESC <hex IB, CHR$<27)). 

Use bottom of double high characters 
Use compressed print and dump width 
Use downward facing characters 
Use Atari font. Graphic mode 
Do a printer formfeed 
Do a graphic dump to printer 
Initialize vectors 

Use normal printer font, normal mode 
Print all text on screen 
Read screen dump from disk 
Use "translated" printer font 
Write screen dump to disk 
Dn:fllename.ext Change disk dump file name 
Disable swltch-to-graphlc recognition 
Enable swltch-to-graphlc recognition 
Toggle hardcopy 
Use left facing characters 
Set margin to x lOtha of an Inch 
Use normal width, height, and right facing 
characters; normal width, black and white dumps 
Switch to normal passthrough mode 
Use right facing characters 
Use multi-colored (shaded) dumps 
Use top of double high characters 
Use upward facing characters 

:de Set shaded darkness values, 0-3 for "color" 
registers 0,1,2,3 and 4 respectively 
Start underscored characters 
Stop underscored characters 
Change escape character to x (any character) 

Esc Esc Switch to graphic mode (accepted In normal 
mode data. Ignored In graphic mode data) 



- 6.4 - 



Esc 


B 


Eac 


C 


Esc 


D 


Eac 


GA 


Esc 


GF 


Esc 


GG 


Esc 


GI 


Esc 


GN 


Esc 


GP 


Esc 


GR 


Esc 


GT 


Esc 


GUI 


Esc 


G=I 


Esc 


G- 


Esc 


G* 


Esc 


H 


Esc 


L 


Esc 


Mx 


Esc 


N 


Esc 


P 


Esc 


R 


Esc 


S 


Esc 


T 


Esc 


U 


Esc 


Vab 


Esc 


C 


Esc 


] 


Esc 


=x 



[ 
[ 
[ 
[ 
[ 
[ 
[ 
[ 
[ 
[ 
[ 
[ 
[ 
[ 
[ 



KEYl^OARD COMMANDS 

The following conmands are recognized from the Atari 
keyboard anytime after ICEGRAF la loaded. CI/Vl = Znverae 
Video (Atari) Key 



CSHIFT3 
CCTRL3 - 
CCTRL3 - 
CCTRL3 - 
tCTRL] - 
CCTRL3 - 
[CTRL3 - 
CCTRL3 - 
CCTRL3 - 
tCTRL3 - 
[CTRL3 - 
CCTRL3 - 
CCTRL3 - 



-CI/V3 

CI/V3 

CI/V3 

CI/V3 

CI/V3 

CI/V3 

CI/V3 

CI/V3 

CI/V3 

CI/V3 W 

CI/V3 - 

CI/V3 ♦ 

CSHIFT3 



Print line containing the curaor 
Uae Atari font. Graphic mode 
Do a printer formfeed 
Do a graphic dump to printer 
Initialize vectors 

Uae normal printer font, normal mode 
Print all text on acreen 
Read screen dump from disk 
Uae "translated" printer font 
Write screen dump to disk 
Disable awltch-to-graphlc recognition 
Enable swltch-to-graphlc recognition 
1 1 / V 3 Togg 1 e Har dcopy 



- 6.5 - 



[ 
[ 
[ 
[ 
[ 
[ 
[ 
[ 
[ 
[ 
[ 
[ 
[ 
[ 
c 



ACCESSXMG THE XCEPXC HARDWARE 



The ICEPIC uaea all of the functlona of the game port into 
which it ia connected: joystick, trigger, and paddlea. 
Normally there ia little reaaon for you to want to "talk" to 
the ICEPIC except through the driver prograna. In fact, the 
actual operation of the ICEPIC requirea aome tricky program 
tining, ao you ahould not even conaider running it youraelf . 
However, there are aome "atatua** aignala you might be 
intereated in knowing. In particular, you can check if the 
printer ia buay, if it ia aelected (online for some 
printers), or if it haa a "fault" condition (off-line, out 
of paper, or aerious error for moat printers) • The exact 
meaning of these signala variea among printer manufacturers; 
consult your printer's manual for the exact meaninga. 



S-TA-rUS I^OCATXOMS AMD VAI^UEIS 



Signal: BUSY 

Port 2 Addresses: STRIG(l) 

Port 4 Addresses: STRIGO) 

"True" Valuea: 

"Falae" Values: 1 



SELECTED 
PADDLE (2) 
PADDLE (6) 
> 128 
< 128 



FAULT 

PADDLE (3) 

PADDLE (7) 

< 128 

> 128 



The ICEPIC software will check all of these signals whenever 
you do a printer operation and it will report an error code 
if they are not correct. But if you want to check in 
advance or further determine the cause of a problem from 
your programs, you can look at the values at any time. 



7.1 - 



[ 



THE JOYSTXCK ADDRESS 

The "STICK" (3oystlck) values will have little meaning to L 
you because they are used to pass data to the ICEPIC and to 
receive acknowledgement from the ICEPIC. You should not 
write (POKE) to the joystick port because it can cause 
strange printing to occur. If you run a program which 
changes the Input/Output control register for the joystick, p- 
the ICEPIC may no longer function (until you OPEN a print 
file, do a SYSTEM RESET or boot the system). Although it's ^ 
unlikely that you could damage the ICEPIC by modifying the 
"STICK" settings, it should be avoided. 



[ 



- 7.2 - 



[ 
[ 
[ 
[ 
[ 
[ 
[ 
[ 
[ 
[ 
[ 



OTHER XNTERFACES 



USXMTG XCEPXC WX-TH A MODEM 

If you own an Atari d50 or ainilar moden- connecting device 
you are aware of a serloua limitation: you cannot 
alRultaneoualy receive data from a remote ayatem and print 
It In "real time". Thla la due to the fact that the 850 
"takea over" the I/O channel when It la sending or receiving 
(or waiting to receive) data from the modem. The ICEPIC can 
aolve thla problem for you. Aa you know. It doea not uae 
the channel and la therefore free to print at any time. You 
can make uae of thla In two ways... 

USXNG XCEGRAF FOR PRXMTXNG 

For many "modem" programa, you need only to previously load 
ICEGRAF and activate "HARDCOPY" whenever you want to print 
whatever la going to the acreen or you can uae the "print 
acreen" function to print what la already on the acreen. On 
higher apeed llnea you may need a larger Input buffer In 
your modem program (If thla la poaalble) to avoid loat data 
when waiting for aome printer operatlona. Thla can be 
avoided by doing a "print acreen" only when the remote 
ayatem la not actually talking (the 850 atlll haa the 
channel but no data will come In) . 

DOXMG X-r AL.1^ YOURSEI^F 

For the more ambltloua, there la another route which can 
give you even more flexibility: your program can open a 
printer file and print whatever you want, whenever you want. 
Thla method requlrea that you can change the modem program, 
of courae. You can uae either PHANDLER or ICEGRAF aa your 
ICEPIC driver. 



- 8.1 - 



[ 
[ 
[ 
[ 
[ 
[ 
[ 
c 
[ 
[ 
[ 
[ 
[ 
[ 
[ 



UTXI-XTV PROGRAMS 

In addition to the many driver prograna on your ICEPIC 
software diskette, you will find several "utility" programs 
which will be useful for several special functions. 



xcECHK DXAGnros-rxc 

You used this program during your Initial checkout 
procedure. It can be used, at any time, to verify that 
everything Is working. It does not depend on an external 
ICEPIC driver program, so It can Isolate a problem to 
hardware or software: If the ICEPIC works with the 
diagnostic but not with another driver, the problem Is with 
the driver (how you are using It, most likely); If the 
ICEPIC does not work with ICECHK, you will be told the cause 
of the problem and the likely solution. Since different 
printer manufacturers use slightly different ways of 
reporting error conditions, ICECHK cannot be too specific In 
Identifying some problems -- It should catch the common 
ones. There are two versions of ICECHK: 

ICECHK2 — for ICEPIC connected to port 2. 
ICECHK4 -- for ICEPIC connected to port 4. 

Two problems which cannot be caught directly by ICECHK are 
(1) no auto-llnefeed (overprinting) and (2) printer In 
abnormal mode (graphics, for example). The first problem 
will be obvious when you look at the printout -- change your 
printer setup switch to correct It (you might need to turn 
the printer off and on again to make It look at the new 
setup switch setting). The second problem looks like your 
printer has just stopped working -- turn its power off, then 
back on, to correct it. You can get "stuck" in graphics 
mode by accidentally printing the appropriate printer 
control sequence or if you abnormally terminate a graphics 
dump (by booting, for example). 



- 9.1 



SETUP PROGRAM 

The SETUP program allows you to eatabllah ICEGRAF graphic 
dump parameters before running any application program. It 
is quite useful with programs which will not allow you to do 
screen text printing (such as many of the graphic tablet 
programs). SETUP will allow you to change to compressed 
dumps, to get shaded dumps and set shade "color** values, and 
to re-specify the disk dump file name. You must load 
ICEGRAF before you load SETUP. You can run SETUP by loading 
it from DOS, or since SETUP is an ''INIT** program (runs 
before the rest of AUTORUN.SYS is loaded), it can be part of 
an AUTORUN.SYS file to which you append the application you 
want to run (it will run after SETUP). For many 
applications you will want to first copy ICEGRAF. xxx to 
AUTORUN.SYS then copy/append SETUP to AUTORUN.SYS and 
finally copy/append the application you want to run. Be 
CAREFUL if the application is already "AUTORUN.SYS" -- 
rename it first. If you are using a cartridge application, 
3ust copy/append SETUP to ICEGRAF as your AUTORUN.SYS. 
Cartridge programs usually will not give you a chance to 
load programs except as part of AUTORUN.SYS. 



9.2 - 



[ 
[ 
[ 



REBOOT PROGRAM 

REBOOT allows you to load a driver before you boot up 
another disk. It starts a boot without requiring that the 
computer power be turned off, so programs can stay in 
»enory. REBOOT does not clear (zero out) page 6, nor does 
it re-determine RAM size before it starts the bootup. Thus, 
anything "hiding" in high memory or page 6 will not be 
destroyed. In addition, REBOOT does not alter system 
vectors and parameters, so any currently active device 
drivers will remain active. Beyond this, REBOOT does a 
standard boot process, so almost any bootable disk can be 
REBOOTed. There are two ma3or ways to use REBOOT: you can 
manually load it after you have loaded the driver you want 
to use, or you can make the driver an AUTORUN.SYS file and 
append REBOOT to that. REBOOT must be the last thing you 
append in your AUTORUN.SYS file since it "RUNs" (no INIT 
address and the "boot" usually replaces DOS, so nothing more 
could run). Creating such an AUTORUN.SYS allows you to 
simply insert the REBOOT diskette, boot it, and then replace 
it with the diskette you really want to boot. 

REBOOT will pause to give you a chance to insert the new 
diskette. You must REBOOT from drive 1 (like a normal 
boot). If an initial disk error occurs (like drive not 
ready), REBOOT will print "BOOT ERROR" and try again. Once 
the boot process starts, any disk error will "hang" the 
system and you must start all over (rare occurrence) . 

REBOOT will only work with high memory or page 6 drivers 
(other memory will be cleared, thus destroying low memory 
drivers) . If the system being booted uses page 6 at any 
time, you will not be able to use a page 6 driver. If the 
system being booted does not respect high memory or requires 
a full 48k, you cannot use a high memory driver. 

Due to a bug in some early OS ROM's, DOS 2 and its 
derivatives patched some SIO vectors. This patch is removed 
by REBOOT because DOS will most likely be overlaid by the 
software you are REBOOTing. The restore of OS vectors may 
fail if you are being quite fancy and use a non-standard OS: 
using standard OS or DOS 3 will avoid this problem. 

- 9.3 - 



SHOMXCRO PROGRAM 

SHOMICRO allows you to dump (via ICEGRAF) files created by 
MicroPalnter . It is needed because MicroPainter requires 
all 4dk and so you cannot load ICEGRAF. To use SHOMICRO: 

1. While using MicroPainter, save any pictures you want 
to dump. 

2. Boot up your nornal DOS. 

3. Load ICEGRAF. xxH. 

4. Load SHOMICRO. 

5. Insert the diskette with your MicroPainter files into 
your drive. 

6. Answer SHOMICRO prompts as desired. 

SHOMICRO will first perform a "SETUP" and then ask you for 
the file you want to display. It will read it and show it 
to you. While it is on the screen , you can use the ICEGRAF 
keyboard functions to either dump it to print or write it on 
disk. After each picture, SHOWMICRO will give you a chance 
to display another file and/or change the SETUP parameters. 
Any ICEGRAF dumped files will most likely use less disk 
space than original MicroPainter files because ICEGRAF 
compresses the data. 



DXSPL.AYX14G — ARTIST" PICTURES 

XN BASXC 

If you use ICEGRAF to dump a MicroPainter picture (or most 
other "artist" pictures) to disk, you can write a BASIC 
program containing the following statements: 

GRAPHICS 8^16 

OPEN #2,4,0,"G:filename.ext" 

"filename .ext'* is the name of the file you dumped with 
ICEGRAF (specified during SETUP). You will get a display of 
your orignal picture, in its original colors. Thus, you 
could make a "slide show" of pictures created by your 
painter or incorporate the pictures as part of a game or 
other presentation. 

- 9.4 - 



[ 



[ 
[ 
[ 



REOUXREMEMTS 

The following application programs have been tested with the 
ICEPIC and worked with the drivers specified for each. It 
would be nearly Impossible to test all available 
applications -- If you have one which Is not listed, try 
using the procedure for a listed application which Is 
similar to yours. 

In the descriptions which follow, ICEGRAF.xnH, ICEGRAF.xnL, 
PHANDLER.nLM, PHANDLER.nP6, and SIOSIM.nLH mean you should 
use the version of the driver which corresponds to your 
hardware i*x* designates printer graphics type and *n' the 
joystick port number). See the chapter on ICEGRAF or 
PHANDLER for details. 

BASXC PROGRAMS 

The following procedure will work with most BASIC programs: 

1. Before loading or running your program, exit to DOS 
("DOS"' command). 

2. From DOS, load ICEGRAF. xnH (see page 6.1). 

3. Return to BASIC (run cartridge) and use BASIC as usual. 

4. All of the ICEGRAF functions will be available at the 
keyboard . 

5. Your program can use P: and G: to print and dump. 

Any of the ICEPIC drivers will work with "simple" BASIC 
programs. There are two ways to load a driver: (1) go to 
DOS and load the driver or (2) make the desired driver your 
AUTORUN-SYS file. ICEGRAF. xnH works best for most uses (but 
System Reset destroys the disk dump portion). IGEGRAF.xnL 
works best as an AUTORUN.SYS if you are not going to get 
into DOS and run any program from DOS. If you do not want 
to use the ICEGRAF functions (just want to print) and you 
need every bit of memory (ICEGRAF uses 4k), you can use 
PHANDLER. nLM or PHANDLER. nP6 -- they only use around 256 
bytes. If your BASIC program does not use page 6, 
PHANDLER. nP6 gives you the maximum available memory. 
Remember that loading the low memory drivers (PHANDLER. nLM 

- 10.1 - 



or ICEGRAF.xnL) from DOS 2 can be a tricky procedure -- 
Biaking the driver into your AUTORUN.SYS file ia easiest. 

If you wish to LIST a BASIC program <or any other kind of 
program) and it contains "control characters" (many of the 
Atari special symbols) you should activate "translated" 
printing to avoid having your printer do strange things. 
This can be accomplished by adding the following statement 
to the program being listed: 

1 REM CEc] [Ec3 CEclGT 

CEcl is an escape character -- press the CESCl key twice to 
get one. When this line is "printed", ICEGRAF will start 
using "translated" output. Any control characters will 
appear as underscored letters and any inverse characters 
will be italicized (emphasized on Okidata printers). You 
can also activate translated printing through the ICEGRAF 
keyboard sequence AFTER you start the listing -- you must be 
quick if any control characters are near the start of the 
program. 

The following procedures should be used with AtariWriter: 

A. If you are not using one of the AtariWriter print 
drivers, copy PHANDLER.nLM to AUTORUN.SYS on the disk you 
will boot with AtariWriter. 

B. If you are using an AtariWriter print driver, copy 
SIOSIM.nLM to the AUTORUN.SYS and copy /append your driver to 
that. 

If you want some of the ICEGRAF features (such as Atari 
font), substitute ICEGRAF.xnL for either PHANDLER or SIOSIM 
in the previous steps. Note that ICEGRAF will use up 4k 
more of memory. 



10.2 - 



[ 
[ 



I^JK E^ETT-ER PERFECT 

The following procedure worka with Let.-ber Perfect: 

1. Boot your normal DOS and load ICEGRAF.xnH. 

2. Load REBOOT, insert your Letter Perfect diskette and 
press [Start] . 

3. After Letter Perfect has booted, press 
CCTRLl - [Inverse/ Video] then I so ICEGRAF will survive if you 
later must press [SYSTEM .RESET] . 

Because Letter Perfect uses a non-standard DOS, you should 
not use the disk functions of ICEGRAF while in Letter 
Perfect (there is not much need for then) • 

By^GRAPH 

B/GRAPH can be used with the ICEPIC in two ways: (1) use 
noraal B/GRAPH dumping via PHANDLER.nLM or (2) use the SHOW 
program of B/GRAPH along with ICEGRAF.xnH to get various 
formats of dumps. ICEGRAF cannot be used with the 
full-fledged B/GRAPH because there is not enough memory. 

To use the normal B/GRAPH print functions: 

1. Copy PHANLDER.nLH onto a DOS diskette as AUTORUN.SYS. 

2. Boot this diskette with BASIC present. 

3. Insert the B/GRAPH diskette. 

4. RUN "D: START". 

To use ICEGRAF along with B/GRAPH ^s "SHOW" program: 

1. Boot from a normal disk with BASIC present (and no 
AUTORUN.SYS) . 

2. Exit to DOS, and load ICEGRAF.xnH. 

3. Return to BASIC. 

4. Insert the B/GRAPH diskette. 

5. Run "D:SH0W". 

6. Follow the B/GRAPH instructions to get a display of the 
chart you want to dump. 

7. Use the ICEGRAF keyboard dump commands to make your 
dumps. 

- 10.3 - 



KOAl^A MXCRO XI^I^USTRATOR 
ATTAR X ART XS-r 

For cartridge based veraions do the following: 

1. Boot up a normal DOS disk. 

2. Copy ICEGRAF.xnL to AUTORUN.SYS on the diskette you will 
use with your art program. 

3. Copy /Append SETUP to AUTORUN.SYS. 

4. Insert your cartridge and boot from the diskette. 

5. Answer the SETUP questions as desired. 

6. Run art program as usual. 

7. Use ICEGRAF keyboard dump commands to print or dump the 
picture. 

For disk based versions: 

1. Boot up a normal DOS disk. 

2. Insert the art program software diskette. 

3. Rename the current AUTORUN.SYS to TEMP. PGM. 

4. Copy ICEGRAF.xnL to AUTORUN.SYS on the art program 
diskette. 

5. Copy /Append SETUP to the AUTORUN.SYS. 

6. Copy /Append TEMP. PGM to the AUTORUN.SYS. 

7. Boot from the art program diskette. 

8. Answer the SETUP questions as desired. 

9. Run art program as usual. 

10. Use ICEGRAF keyboard dump commands to print or dump the 
picture. 

Once you have created the necessary AUTORUN.SYS you will 
only have to do the last four steps in the future. You must 
SETUP the ICEGRAF graphic dump parameters in advance because 
these programs never have a text screen where you could 
••print" the required control information. When you start an 
ICEGRAF dump to print or disk, the screen may go blank or go 
into magnified view -- the dump will be of the original 
picture. When the dump completes, you will usually end up 
back on the menu page. The menu page will not dump 
correctly because it uses •'display list interrupts*' and 
changes character sets. 



- 10.4 



If you nake a dump to disk, it can be used by BASIC programs 
if you follow the procedure under '*SHOHICRO" (page 9.4). If 
you need to change the disk dump name, you must reboot and 
reply appropriately to the SETUP prompts. The first four 
"shade" values in ICEGRAF SETUP correspond, left to right,, 
with the colors on the menu page. The fifth "shade" value 
is not used by the art programs (but must be specified -- 
use 0) . A shade value of O is "white" (no print) . Values 
of 1, 2 and 3 are progressively "blacker". 

M X CROP A X MTER 

ICEGRAF does not work directly with HicroPainter because 
MicroPainter uses all of memory. However, you can still 
print your pictures by using SHOHICRO after you have saved 
your pictures from HicroPainter. See SHOHICRO (page 9.4) 
for more information. 



- 10.5 - 



[ 
[ 
[ 
c 

[ 
[ 
[ 

[ 
c 
c 
c 

c 
c 
[ 
c 



[ 
[ 
[ 
[ 
[ 
[ 
[ 



[ 
[ 
[ 
[ 
[ 
[ 



SRROR OODES 

The ICEPIC drivers will check for several types of error 
conditions and report them as error codes when a command for 
the printer is issued- The following codes are reported: 

Code 138 (Device Timeout) means that the ICEPIC is not 
responding -- it's probably not plugged into the correct 
game port. 

Code 139 (Device NAK) means that the printer is reporting a 
"fault" or is not "selected" -- it can be caused by several 
conditions. The printer may be offline, turned off, out of 
paper, or have a serious hardware problem. 

Both of these errors are returned immediately during an OPEN 
or STATUS operation. If the printer becomes "not ready" 
during printing, ICEPIC software will start "beeping" the 
keyboard "buzzer" until you ready the printer or press 

CBREAK3 • The CBREAK3 key will cause error code 139 to be 
reported to the program. Due to memory limitations, the 
page 6 version of SIOSIM can only perform the OPEN checks -- 
it may hang temporarily if errors occur during printing 

(until the error is corrected). 

XCEGRAF* KEYBOARD COMMANDS 

If ICEGRAF detects a printer error condition while doing a 
keyboard activated command, it will start "beeping" until 
you ready the printer. If you use CBREAK3 to end the 
"printer not ready" condition, ICEGRAF will stop the current 
function (there may be a short delay on graphic dumps) . In 
addition, your printer may end up "stuck" in graphics if you 
were in the middle of a graphic dump or "Atari" font 
printout. So if your printer goes "off line" during a 
graphic dump and you decide to terminate the dump (by 
pressing CBREAK3 ) , you should turn the printer off and back 
on again to avoid leaving it in graphics mode. 



- 11.1 



[ 
[ 
[ 
[ 
c 
[ 
c 
c 
c 
c 
c 
c 
[ 
[ 
[ 



T-ROUBl^E — SHOCJ-r X MG 



There are four ma3or causes of problems encountered while 
using the ICEPIC: 

1. Printer hardware settings and connections. 

2. ICEPIC hardware connections. 

3. Improper use of ICEPIC software. 

4. Actual hardware failures. 

When you have a problem, the first thing to do is to 
determine which class of problem you have. This is most 
easily accomplished by running the ICECHK diagnostic 
program . 

PRXMTER HARDWARE SEHTUP 

Check the following items on your printer: 

1. Is it plugged into the power ? 

2. Is its power turned on ? 

3. Is it ON LINE or SELECTED ? 

4. Is it out of paper ? 

5. Is it set up to use the parallel interface ? (Option on 
some printers.) 

6. Is the setup switch for automatic linefeed "on" ? 

7. Is it "stuck" in graphics mode ? (Turn it off, then on, 
to reset it.) 

8. Has it accepted its setup switch settings ? (Often you 
must turn it off and on again to get the settings to 
"take" . ) 

ICE:T>:1:C hardware COKiHECTIOHS 

Check the following items: 

1. Is the ICEPIC completely plugged into the printer ? 

2. Is the ICEPIC completely plugged into the "joystick" 
port ? 

3. Is the ICEPIC plugged into the correct joystick port for 
the driver in use ? 

- 12.1 - 



XMPROPER USE OF XCEPXC 
SOFTWARE 

To determine if you have a software problem » run the ICECHK 
diagnostic -- if it works, it is likely that you do have a 
software problem. The most likely software problem is the 
use of the wrong driver with a given application. The most 
common such error is the use of a driver which gets 
destroyed or overlaid by the application or by DOS itself. 
Reread the sections on selecting a driver and the section 
pertaining to the driver you are attempting to use. ICEPIC 
software may not work with some applications, particularly 
those which use every bit of memory and those which use 
non-standard ways of accessing Atari hardware. 

While somewhat rare, you could destroy a driver on disk by 
writing over it or perhaps by a disk error. This should be 
suspected if a driver, which used to work, suddenly does not 
work the same. Go back and copy the driver from the 
original ICEPIC diskette if this happens. 

One problem area which is not understood by many Atari users 
is DOS 2's DUP.SYS. This is the program which builds the 
DOS "menu" and determines what you want to do. To reduce 
memory requirements, DUP.SYS is loaded when it is used. It 
loads at a fairly low memory address and can therefore 
overlay a program (driver) which is loaded in low memory. 
So if you load a low memory driver from DUP.SYS, it might be 
destroyed when DUP.SYS comes back to ask you what to do 
next. DOS supports a function to save anything in low 
memory to a disk file (HEM.SAV). Since writing this file 
takes some time and since there must be room for it on the 
diskette being used, most users do not use it. Even if you 
do use a MEM.SAV, you must not try to use print (or ICEGRAF) 
functions while the driver is "swapped out" on disk (while 
DUP.SYS -is active). As a result, it is not usually 
advisable to load a low memory driver from the DOS 2 menu. 
If you need to use a low memory driver, you can make the 
driver an AUTORUN.SYS or part of AUTORUN.SYS. For cartridge 
programs, DOS will automatically load AUTORUN.SYS (your 
driver) before it gives control to the cartridge program. 
For disk based applications, you can copy/append your 

- 12.2 - 



application to the driver aa part of AUTORUN.SYS; the 
application will be loaded and run after the driver has been 
loaded . 

ACTUAI^ HARDWARE FAXI^URES 

Actual hardware failures fall into two groups: intermittent 
and consistent. In the intermittent category, there can be 
cases where a letter or two are misprinted and other cases 
where things stop working for a while. Both of these cases 
are often due to electrical "noise". Such noise can be 
caused by plugging the printer and the computer into 
different power circuits (outlets) or by using some heavy 
duty appliance on the same circuit. Plugging everything 
into the same outlet strip and perhaps using a noise 
suppressing outlet strip can often solve such problems. 

Consistent hardware failures are usually more serious but 
often easier to find -- nothing ever works. There are three 
pieces of hardware which can fail: the Atari computer, the 
ICEPIC, and the printer. If a joystick works in the 
"ICEPIC" 3ack, the Atari is probably OK. You can check port 
2 with the following simple BASIC program (moving the 
joystick in all directions should give changing values) : 

10 ? STICK(l) :GOTO 10 (Use STICK (3) for Port 4) 

The determination whether the ICEPIC has failed or whether 
the printer has failed can best be done by substitution. If 
you can, try the printer on another system with a printer 
interface which works. Or try using another printer which 
works on another system. Or, if available, try substituting 
another ICEPIC. Most printers have a "self test" which will 
tell you if the printer is bad . Unfortunately, the test 
will not tell you if the printer is good — the tests cannot 
check the parallel interface. Check your printer manual for 
more suggestions on trouble-shooting. If you are fairly 
certain the ICEPIC does not work, refer to the ICEPIC 
warranty for repair policy. 



- 12.3 



I^XMITED WARRANTY 



Integrated Computer Equipment Company (**ICECO**) warrants that this 
product, the Parallel Interface Converter ("ICEPIC") and the diskette 
medium, containing the supporting software, is free from defective 
material and workmanship. Subject to the conditions set forth below, 
ICECO agrees to repair or replace any ICEPIC or ICEPIC software diskette 
which proves defective by reason of improper workmanship or materials 
for a period of ninety (90) days from the original retail purchase date, 
without charge for parts and labor. After the warranty expires, ICEPIC s 
will be repaired or replaced for a prepaid flat fee of S15.00 plus $4.00 
for shipping and handling. 

Defective units may be returned, intact and postpaid, to the original 
seller of such unit or to ICECO directly and must be accompanied by a 
proof of purchase receipt or, if out of warranty, by a check or money 
order for $19.00. ICECO requires that the Problem Reporting Form be 
filled out by the retail purchaser and returned along with the defective 
ICEPIC. 

While the ICEPIC software has been extensively tested, it is sold **a8 
is" with no warranty, expressed or implied, for any particular purpose. 
However, if the ICEPIC, with its accompanying software, is totally 
unacceptable to the original purchaser, the purchase price, less 
shipping and handling charges, will be refunded upon return, postpaid, 
of the undamaged ICEPIC, original software diskette, and user's manual, 
all in the original package, to the seller of this product, subject to 
the conditions set forth below. This "money back** satisfaction 
guarantee shall be in effect for a period of thirty (30) days from the 
original retail purchase date. 

These warranties are limited to the original retail purchaser of the 
ICEPIC. These warranties are not effective unless the ICEPIC was 
purchased from ICECO, an authorized ICECO dealer or other person 
authorized by ICECO to sell ICECO products. The ICEPIC and ICEPIC 
diskette shall not have been subject to accident, misuse, or abuse, nor 
operated contrary to the instructions contained in the ICEPIC User's 
Manual. The ICEPIC software diskette's write-protect seal shall not 
have been removed nor any data written onto the diskette by anyone other 
than ICECO. The ICEPIC shall not have been previously repaired or 
altered by anyone other than an ICECO authorized service facility. 

ICECO and ICECO distributors shall not be liable for any direct, 
indirect, incidental, consequential, or other types of damages resulting 
from the use of the ICEPIC and its accompanying software other than the 
liability stated above. In particular, ICECO shall have no liability 
for any other hardware or programs used with this product, including 
the coat of reproducing any such programs and data. These warranties 
are in lieu of all other warranties, expressed or implied. Some states 
do not allow the exclusion or limitation of implied warranties or 
liability for incidental or consequential damages, so the above 
limitations or exclusions may not apply to you. 



[ 
[ 
[ 
[ 
[ 
[ 
[ 
[ 
[ 
[ 
[ 
[ 
[ 
[ 
[ 



c 
c 
[ 
c 
c 
c 
c 
c 
c 
[ 
[ 
c 
[ 
c 
r